package cn.iocoder.yudao.module.trade.cart.service;

import cn.iocoder.yudao.module.api.product.spu.dto.ProductSpuRespDTO;
import cn.iocoder.yudao.module.trade.cart.dal.dataobject.CartDO;
import cn.iocoder.yudao.module.trade.cart.vo.AppCartAddReqVO;
import cn.iocoder.yudao.module.trade.cart.vo.AppCartResetReqVO;
import cn.iocoder.yudao.module.trade.cart.vo.AppCartUpdateCountReqVO;
import cn.iocoder.yudao.module.trade.cart.vo.AppCartUpdateSelectedReqVO;
import jakarta.annotation.Nullable;
import jakarta.validation.Valid;

import java.util.Collection;
import java.util.List;
import java.util.Set;

/**
 * 购物车 Service 实现类
 *
 * @author 芋道源码
 */
public interface CartService {

    /**
     * 添加产品到购物车
     *
     * @param userId 用户编号
     * @param addReqVO 添加信息
     * @return 购物项的编号
     */
    Long addCart(Long userId, @Valid AppCartAddReqVO addReqVO);

    /**
     * 更新购物车产品数量
     *
     * @param userId 用户编号
     * @param updateCountReqVO 更新信息
     */
    void updateCartCount(Long userId, AppCartUpdateCountReqVO updateCountReqVO);

    /**
     * 更新购物车选中状态
     *
     * @param userId 用户编号
     * @param updateSelectedReqVO 更新信息
     */
    void updateCartSelected(Long userId, @Valid AppCartUpdateSelectedReqVO updateSelectedReqVO);

    /**
     * 重置购物车产品
     *
     * 使用场景：在一个购物车项对应的产品失效（例如说 SPU 被下架），可以重新选择对应的 SKU
     *
     * @param userId 用户编号
     * @param updateReqVO 重置信息
     */
    void resetCart(Long userId, AppCartResetReqVO updateReqVO);

    /**
     * 删除购物车产品
     *
     * @param userId 用户编号
     * @param ids 购物项的编号
     */
    void deleteCart(Long userId, Collection<Long> ids);

    /**
     * 删除购物车产品
     *
     * @param userId 用户编号
     * @param shopId 店铺编号
     */
    void deleteCart(Long userId, @Nullable Long shopId);

    /**
     * 查询用户在购物车中的产品数量
     *
     * @param userId 用户编号
     * @param shopId 店铺编号
     * @return 产品数量
     */
    Integer getCartCount(Long userId, @Nullable Long shopId);

    /**
     * 查询用户在购物车中的产品数量
     *
     * @param userId 用户编号
     * @return 产品数量
     */
    default Integer getCartCount(Long userId) {
        return getCartCount(userId, null);
    }

    /**
     * 查询用户的购物车列表
     *
     * @param userId 用户编号
     * @param shopId 店铺编号
     * @return 购物车列表
     */
    List<CartDO> getCartList(Long userId, @Nullable Long shopId);

    /**
     * 查询用户的购物车列表
     *
     * @param userId 用户编号
     * @return 购物车列表
     */
    default List<CartDO> getCartList(Long userId) {
        return getCartList(userId, (Long) null);
    }

    /**
     * 删除购物车产品，如果 SPU 被删除
     *
     * @param carts 购物车列表
     * @param spus SPU 列表
     */
    void deleteCartIfSpuDeleted(List<CartDO> carts, List<ProductSpuRespDTO> spus);

    /**
     * 查询用户的购物车列表
     *
     * @param userId 用户编号
     * @param ids 购物项的编号
     * @return 购物车列表
     */
    List<CartDO> getCartList(Long userId, Set<Long> ids);

}
